Skip to content

Update agent frontmatter options to remove deprecated "infer"#1022

Closed
Anddd7 wants to merge 1 commit intogithub:mainfrom
Anddd7:deprecated-infer-agent-instruction
Closed

Update agent frontmatter options to remove deprecated "infer"#1022
Anddd7 wants to merge 1 commit intogithub:mainfrom
Anddd7:deprecated-infer-agent-instruction

Conversation

@Anddd7
Copy link
Contributor

@Anddd7 Anddd7 commented Mar 16, 2026

  • Removed deprecated 'infer' property and replaced it with 'user-invocable' and 'disable-model-invocation'
  • Clarified usage of new properties for better agent configuration
  • Updated guidelines to reflect changes in agent visibility and invocation

Pull Request Checklist

  • I have read and followed the CONTRIBUTING.md guidelines.
  • I have read and followed the Guidance for submissions involving paid services.
  • My contribution adds a new instruction, prompt, agent, skill, or workflow file in the correct directory.
  • The file follows the required naming convention.
  • The content is clearly structured and follows the example format.
  • I have tested my instructions, prompt, agent, skill, or workflow with GitHub Copilot.
  • I have run npm start and verified that README.md is up to date.

Description


Type of Contribution

  • New instruction file.
  • New prompt file.
  • New agent file.
  • New plugin.
  • New skill file.
  • New agentic workflow.
  • Update to existing instruction, prompt, agent, plugin, skill, or workflow.
  • Other (please specify):

Additional Notes

https://code.visualstudio.com/docs/copilot/customization/custom-agents#_custom-agent-file-structure

infer | Deprecated. Use user-invocable and disable-model-invocation instead. Previously, infer: true (the default) made the agent both visible in the picker and available as a subagent. infer: false hid it from both. The new fields give you independent control: use user-invocable: false to hide from the picker while still allowing subagent invocation, or disable-model-invocation: true to prevent subagent invocation while keeping it in the picker.

By submitting this pull request, I confirm that my contribution abides by the Code of Conduct and will be licensed under the MIT License.

* Removed 'infer' property and replaced it with 'user-invocable' and 'disable-model-invocation'
* Clarified usage of new properties for better agent configuration
* Updated guidelines to reflect changes in agent visibility and invocation
@Anddd7 Anddd7 requested a review from aaronpowell as a code owner March 16, 2026 06:43
Copilot AI review requested due to automatic review settings March 16, 2026 06:43
@Anddd7 Anddd7 closed this Mar 16, 2026
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the custom agent authoring guidelines to align with the newer frontmatter options by removing the deprecated infer field and documenting the replacement visibility/invocation controls.

Changes:

  • Removed infer from the sample agent frontmatter.
  • Added documentation for user-invocable and disable-model-invocation, including updated checklist guidance.

#### **disable-model-invocation** (OPTIONAL)
- Boolean controlling whether the agent can be invoked as a subagent by other agents
- Default: `false` if omitted
- Set to `true` to prevent subagent invocation while keeping it available in the picker
Comment on lines 23 to 30
```yaml
---
description: 'Brief description of the agent purpose and capabilities'
name: 'Agent Display Name'
tools: ['read', 'edit', 'search']
model: 'Claude Sonnet 4.5'
target: 'vscode'
infer: true
---
Comment on lines +63 to +66
#### **user-invocable** (OPTIONAL)
- Boolean controlling whether the agent appears in the agents dropdown in chat
- Default: `true` if omitted
- Set to `false` to require manual agent selection
- Set to `false` to create agents that are only accessible as subagents or programmatically
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants